home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / set_user.zip / SET-USER.DOC < prev    next >
Text File  |  1992-06-07  |  8KB  |  159 lines
  1. +--------------------------[ Set-User Ver 1.00 ]----------------------------+
  2. |  Written By Gary Meeker 06/07/92                        Updated   /  /    |
  3. |  SYSOP: SHARP Technical Support Line BBS               Lawrenceville, GA  |
  4. |         (404) 962-1788                 300/1200/2400/9600 Baud. 24 Hours  |
  5. +---------------------------------------------------------------------------+
  6. V1.00  06/07/92 - Initial release
  7. -----------------------------------------------------------------------------
  8.  
  9.    This program is released as FREEWARE to all REGISTERED PCBoard
  10. Version 14.5(a) Sysops.  The Copyright is retained by Gary Meeker.
  11.  
  12.    What does this mean?  If you have purchased a licence for PCBoard
  13. V14.5(a) from Clark Development, then you are entitled to copy and use
  14. this utility on as many computers as allowed by your licence from Clark
  15. Development.  If you have an illegal copy of PCBoard V14.5(a), this
  16. program is not for YOU.
  17.  
  18. =========================================================================
  19. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  20.  
  21. Every effort has been made to avoid error and moderately extensive testing
  22. has been performed on these programs, however, I do not warrant them to be
  23. fit for any purpose or to be free from error and disclaims any liability
  24. for actual or any other damage arising from the use of these programs.
  25.  
  26. ENSURE YOU KEEP UP-TO-DATE BACKUPS OF ALL YOUR IMPORTANT FILES.
  27.  
  28. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  29. =========================================================================
  30.  
  31. Syntax: Set-User PCBDir  ConfigFile  [/Q] [/P] [/S] [/U] [/L] [/C]
  32.  
  33. Where:     PCBDir = Drive:\Path to USERS.SYS file
  34.        ConfigFile = Drive:\Path\FileName.Ext of Configuration File
  35.  
  36. [/Q] = Quiet (Suppresses the progams output to the screen)
  37. [/P] = Set Level to Password in PWRD File
  38. [/S] = Adjust Only USERS.SYS File if USERS file SecLevel is higher
  39. [/U] = Adjust Only USERS File if USERS.SYS file SecLevel is higher
  40.        If neither /S or /U then adjust to the higher of the two
  41. [/L] = Use the lower level
  42. [/C] = Clear Update status in USERS.SYS if USERS is changed
  43.  
  44. Set-User is designed to update either USERS.SYS or USERS file to the higher
  45. Security Level of the two files. When running two (or more) Door programs from
  46. a single Door Batch file, it is possible to run into problems if the programs
  47. use different methods for updating the Users security level. Some programs will
  48. update USERS.SYS and some will update USERS directly.
  49.  
  50. When the batch file returns to PCBoard, it will update the USERS file to the
  51. level in USERS.SYS, possibly overwriting a higher level level granted by a
  52. program that was run later. By running Set-User after each Door program, you
  53. can be assured that the higher of the two security levels will be retained.
  54.  
  55. Also, some Door programs only work if the User has the proper security level
  56. to use the Door, but if after the first program runs, the USERS file does not
  57. get updated, the second program doesn't see the change and refuses to run.
  58. Set-User will cure this problem also.
  59.  
  60. If you want to control the updating of security levels, you can use /S to
  61. force Set-User to update USERS.SYS file only if the USERS file has a higher
  62. security level, but not to update USERS file if USERS.SYS has the higher.
  63. Likewise, you can use /U to update USERS file only if the USERS.SYS file has
  64. a higher security level, but not to update USERS.SYS file if USERS has the
  65. higher. Used without either parameter, Set-User will always adjust the file
  66. with the lower level to that of the higher level. Using /L will adjust to the
  67. lower of the two levels incase you have a need to do this.
  68.  
  69. In case the first program changes the conference flags and you don't want the
  70. second program to destroy those settings, you add the /C parameter when running
  71. Set-User after the second door runs. This will clear the Updated status in
  72. USERS.SYS so PCBoard will not make any further changes from the file when it
  73. reloads. Since Set-User will have updated USERS from USERS.SYS and nothing else
  74. will be needed from USERS.SYS (hopefully), this should cure this problem also.
  75.  
  76. Eventually, I will get the PCBoard Toolkit (if it gets ported over to Microsoft
  77. C++) and turn this utility into a full USERS.SYS flusher. This will update
  78. USERS & USERS.INF with any changes from USERS.SYS just like when you actually
  79. return to the board, or if the file has not been updated, refresh it from
  80. USERS & USERS.INF just like PCBoard does when it creates the file in the first
  81. place in case a Door or other utility has made a change directly to the User
  82. files.
  83.  
  84. A second mode of operation is to use the /P option. This causes Set-User to
  85. read the PWRD file and if the Users Password matches one of the Passwords in
  86. this file, the Users security level will be set to the corresponding Security
  87. Level. Only the USERS.SYS file is updated and Set-User will exit with an
  88. ErrorLevel equal to the Security Level the User was assigned. This allows
  89. you to perform a test in the Door Batch file and return right to the Board,
  90. Bypassing the normal InstaReg/Verify Door type of set up.
  91.  
  92. NOTE: No USERS.SYS file exists during $$LOGON.BAT so if you were thinking of
  93.       some way to use this program in that batch file, get it out of your head
  94.       right now! Also you MUST set your Door up to create the USERS.SYS file,
  95.       even if the Door itself doesn't need it, cause Set-User does.
  96.  
  97. The configuration file consists of 5 lines:
  98.  
  99. Line 1: Drive:\Path\Filename of USERS File
  100. Line 2: Drive:\Path\Filename of PWRD File
  101. Line 3: Drive:\Path\Filename of TextFile to notify User of Update
  102. Line 4: Security Level Limit (1-255)
  103. Line 5: Set Expiration Level (YES/NO)
  104.  
  105.  
  106. The TextFile in line 3 is a file which if specified will be copied to
  107. PCBDOOR.TXT to be displayed to the User upon return to PCBoard. It is
  108. only for use when the /P parameter is used, and will be copied only if
  109. Set-User finds a password match. Since PCBoard does the displaying of
  110. either of the text file, you may use @Xnn color codes or any of the
  111. @variable@ codes you would like. This allows displaying useful information
  112. to the user.
  113.  
  114. The Security Level Limit in line 4 is for use with the /P parameter also
  115. and sets a limit for the Users level to be raised to by Set-User when a
  116. password match is found. If the match is found on a security level higher
  117. than this limit, then no action is taken (Set-User considers this a no match
  118. condition).
  119.  
  120. Set Expiration Level in line 5 is also for use with /P parameter and if set
  121. to YES it will cause Set-User to adjust the Expired Security Level to the
  122. same level as Security Level if a password match is found.
  123.  
  124.  
  125. A typical entry in an INSTAREG door file would look like this
  126.  
  127. Set-User %PCBDRIVE%%PCBDIR% C:\PCB\Set-User.CFG /P
  128. IF ERRORLEVEL 1 GOTO Exit
  129.  
  130. =========================================================================
  131.  
  132. CONTACTING THE AUTHOR
  133.  
  134. There are a number of ways to contact the author:
  135.  
  136.    1.  Call the support BBS, SHARP Technical Support Line BBS (404) 962-1788.
  137.  
  138.    2.  Fax: (404) 995-0613
  139.  
  140.    3.  Send net mail message through one of the mail networks in a CD-Rom
  141. Sysops, PCBoard, QuickBasic or TeleMate Conference addressed to 'Gary Meeker'.
  142. Available networks are Intelec, Rime, ILink and P/Net. Although I sometimes
  143. do not get on the networks for a couple months at a time, so my BBS or P/NET
  144. which I do carry on my BBS is the quickest bet.
  145.  
  146.  
  147.    4.  Send letter through regular post to the following address:
  148.  
  149.          ATTN: Gary Meeker
  150.          SHARP Technical Support Line BBS
  151.          725-C Old Norcross Road
  152.          Lawrenceville, GA 30245
  153.  
  154. =========================================================================
  155. The file was compiled with PDQ for small size and fast operation. The source is
  156. included (although unless you have Crescent's QuickPack Professional libraries
  157. you won't be able to compile it without changing the references to the
  158. routines I used from the Library.
  159.